home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Gold 2
/
Shareware Gold II - Volume 2 Number 1 - Wayzata Technology (7071) (1991).iso
/
business
/
catalog
/
catalog.man
< prev
next >
Wrap
Text File
|
1991-02-05
|
50KB
|
1,566 lines
CATALOG-ON-A-DISK
For viewing a catalog on your computer.
_______
____|__ | (tm)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
Copyright ■1991, EmmaSoft
TABLE OF CONTENTS
LICENSE AGREEMENT AND WARRANTY. . . . . . . . . . . . . . . . . . . . . . 4
License. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
CHAPTER ONE: INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 7
1.1 What is this thing for????!. . . . . . . . . . . . . . . . . 7
1.2 DEFINITIONS. . . . . . . . . . . . . . . . . . . . . . . . . 7
1.3 TECHNICAL SUPPORT. . . . . . . . . . . . . . . . . . . . . . 8
CHAPTER TWO: VIEWING A CATALOG. . . . . . . . . . . . . . . . . . . . . . 9
2.1 HOW TO READ A CATALOG. . . . . . . . . . . . . . . . . . . . 9
2.2 VIEWING CATALOG INFORMATION AND
ORDERING . . . . . . . . . . . . . . . . . . . . . . . 9
2.3 THE EXIT MENU. . . . . . . . . . . . . . . . . . . . . . . . 10
CHAPTER THREE: MAKING A CATALOG . . . . . . . . . . . . . . . . . . . . . 12
3.1 HOW TO MAKE AN OPENING SCREEN
FILE . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.2 HOW TO MAKE A HEADER FILE. . . . . . . . . . . . . . . . . . 12
3.3 HOW TO MAKE A CATALOG FILE . . . . . . . . . . . . . . . . . 13
3.3a SAMPLE CATALOG FILE . . . . . . . . . . . . . . . . . . . . 14
3.4 HOW TO MAKE AN ORDER INFORMATION
FILE . . . . . . . . . . . . . . . . . . . . . . . . . 14
CHAPTER FOUR: OPTIONS. . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.1 COLORS . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.2 COMMAND LINE FUNCTIONS:. . . . . . . . . . . . . . . . . . . 16
4.3 COMPRESSING CATALOG FILES. . . . . . . . . . . . . . . . . . 17
4.4 EXPORTING CATALOG FILES: . . . . . . . . . . . . . . . . . . 17
4.5 IMPORTING CATALOG FILES: . . . . . . . . . . . . . . . . . . 18
CHAPTER FIVE: COMMANDS . . . . . . . . . . . . . . . . . . . . . . . . . 19
5.1 COMMAND SUMMARY: . . . . . . . . . . . . . . . . . . . . . . 19
5.2 COMMAND LINE FLAG SUMMARY: . . . . . . . . . . . . . . . . . 19
CHAPTER SIX: FILES. . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.1 EXPLANATION. . . . . . . . . . . . . . . . . . . . . . . . . 20
6.2 LIST OF FILES. . . . . . . . . . . . . . . . . . . . . . . . 20
CHAPTER SEVEN: SHAREWARE. . . . . . . . . . . . . . . . . . . . . . . . . 22
6.1 WHAT IS SHAREWARE? . . . . . . . . . . . . . . . . . . . . . 22
6.2 ASP: . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
6.3 ASP OMBUDSMAN ASSISTANCE . . . . . . . . . . . . . . . . . . 23
CHAPTER EIGHT: ORDERING CATALOG ON A
DISK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Registration Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
APENDIX A: Import/Export Features. . . . . . . . . . . . . . . . . . . . 27
APENDIX B: Nationality Setting . . . . . . . . . . . . . . . . . . . . . 27
DUPLICATING CATALOGS:
Sending your catalog on CATALOG-ON-A-DISK can be a lot less
expensive than sending printed catalogs. EmmaSoft can duplicate
your disks for you at very reasonable prices. Small batches are
accepted. Call or write for disk duplication information.
====================================
Copyright 1991 by EmmaSoft
All Rights Reserved
==========================================================================
Page 3
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
LICENSE AGREEMENT AND WARRANTY
License
1. You may use the program on a single computer at one time.
You may not copy the program and accompanying materials except
for backup purposes or to distribute it as shareware (see the
section on distribution).
2. You may not make copies of the program for sale.
3. This software is copyrighted, and all rights therein are
reserved for EmmaSoft. Registration or purchase of this
product does not transfer any right, title, or interest in
the software except as specifically set forth in this agreement.
You are hereby notified that the software product is protected
by United States Copyright Law, and you may be held by
responsible by EmmaSoft for any infringement of such rights
or violations to this agreement.
4. This license is effective until terminated. You may terminate
it at any time by destroying the program and all copies of it.
It will also terminate if you fail to comply with any term or
condition on this agreement. You agree upon termination to
destroy the program together with all copies of the program.
Distribution
1. UNDER NO CIRCUMSTANCES MAY YOU CHARGE MONEY FOR
THIS PROGRAM EXCEPT AS OUTLINED IN NUMBER 4 OF THIS
SECTION.
2. When distributing this program the following files MUST be
included, unchanged from their original form:
Files 1: CATALOG.EXE
CATALOG.INI
FIRSTE.CM
HEADERE.CM
README
CATALOG.MAN
REG.FRM
VENDOR.DOC
CATALG.INF
CMHLP.CM
CMOSHLP.CM
==========================================================================
Page 4
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
If any of the above files are missing from your copy PLEASE
CONTACT EMMASOFT IMMEDIATELY.
If the following files are included they must be unchanged from
their original form:
Files 2: COMSOFT.CM
COMSOFT.TL
DUPLIC.CM
DUPLIC.TL
MUSIC.CM.
MUSIC.TL
SHAREWAR.CM
SHAREWAR.TL
ORDERINF.TXT
3. Registered Users: If the files in the "files 1" section, above,
are all present and intact REGISTERED users may distribute
unlimited copies of CATALOG ON A DISK with their own catalog files
included. No money may be charged for these copies. A
registered user is an individual who has paid the registration fee
to EmmaSoft and received a registered copy with a valid serial
number from EmmaSoft.
Unregistered Users: Unregistered users who wish to distribute
CATALOG ON A DISK may do so ONLY if they charge no money
for distribution (for Vendors, see number 4 below). All files in the
"files 1" AND "files 2" list must be included, unchanged from their
original form. NO EXTRA FILES MAY BE ADDED.
4. Shareware Vendors: Professional vendors of shareware may
distribute CATALOG ON A DISK for not more than $10 (call or
write us for special cases, such as CDs with many programs on
them) provided that the following conditions are met:
a) ALL FILES FROM THE "FILES 1" AND "FILES 2" LIST
ABOVE ARE PRESENT AND UNCHANGED.
b) If you add your own files they must NOT be catalog
files (unless you are a registered user, in which case you
should not charge). They must NOT change the original
catalog files in any way (typically such additional files
give information about the vendor, are batch files for
==========================================================================
Page 5
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
installation, etc.). If you use a compression package
(such as PKZIP) to make your own compressed version
of CATALOG ON A DISK the compressed file MUST
ONLY contain the files in "files 1" and "files 2" above.
c) You must have written permission from EmmaSoft to
distribute the program.
d) There must be a clear explanation of shareware in
your catalog, including that shareware is copyrighted and
not free, that users must register after trying out the
program for a trial period.
e) CATALOG ON A DISK must be clearly identified as
shareware in your catalog and any advertising material it
appears in. The registration fee ($55) must be listed.
Warranty
1. This program is provided "as is" without warranty of any kind,
either expressed or implied, including any warranty of
merchantability or fitness for a particular purpose. In no event
shall EmmaSoft be held liable for any loss of profit, special,
incidental, consequential, or other similar claims.
2. EmmaSoft does warrant that the magnetic media on which the
software is furnished is free of defects of materials and
workmanship under normal use for 60 days, provided that
EmmaSoft provided your copy of the program on such media. If
during this period the diskette should become defective it may be
returned to EmmaSoft for replacement without charge.
Governing law shall be that of New York State.
==========================================================================
Page 5
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER ONE: INTRODUCTION
1.1 What is this thing for????!
CATALOG ON A DISK makes it easy for your customers see your
catalog on their computers and order from it. It is so easy to use that
customers won't put off ordering from you. Also a disk catalog
represents a tremendous savings in production costs. It's simple for
your customers to find what items they want and generate an order
form that can be mailed, faxed, or sent to you by modem. You can
configure your catalog's colors, opening screen and the header above
the section menu, as well as the order form.
Each category can hold 159 items, including their order number,
name, price and a 4 line description of the product. You may have
a total of 99 categories (for a total of 15741 items, disk space
permitting). Your catalog is kept in compressed files so more
product listings can fit on the disk. These are very easy to create on
any word processor or text editor that can save files in pure ascii
format. Then use CATALOG-ON-A-DISK to compress the files.
1.2 DEFINITIONS
In this manual a few terms are used:
Ascii Delimited A file that has been saved in pure ascii
(American Standard Code for Information
Exchange) format (most word processors, data
bases, etc. can do this), that has one or more
data fields delimited by quotation marks and
commas.
Catalog File A compressed file containing catalog
information in five line blocks, with the
extension ".CM" plus a short title file of the
same name with the extension ".TL".
Default File A file CATALOG ON A DISK uses for
anything except catalog information, such as
the opening screen, the main menu header,
and so on. Most of these files have the
extension .CM.
==========================================================================
Page 6
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
Field A database term meaning a type of
information (such as a name, address, etc.).
Menu A box in CATALOG ON A DISK containing
several items that are chosen by placing the
menu bar over the item you want.
1.3 TECHNICAL SUPPORT
CATALOG ON A DISK was written by Dan Veaner. Dan can be
reached at EmmaSoft, or CompuServe at 71460,2644.
Technical assistance is available ONLY to registered users. You must
have a valid serial number to receive assistance. Before calling check
the manual to make sure you are using CATALOG ON A DISK
properly. If so, try using a different copy of the program and see if
the problem continues.
EmmaSoft is opened M-F 9-Noon and 1-5, and sometimes on
Saturdays. When you call for assistance have the following
information ready (if you get the answering machine please leave your
name, serial number, a number where you may be called collect, and
some good times to reach you):
■ Your valid serial number. (You will find this on the
disk label of your registered copy.)
■ Type and make of computer, printer, etc.
■ A concise explanation of the problem (what you tried
to do, what actually happened. How many times you
tried it. Etc.)
EmmaSoft is very interested in hearing your suggestions for future
features in CATALOG ON A DISK. Many of our customers'
suggestions have been incorporated into our programs, so please feel
free to make suggestions.
==========================================================================
Page 8
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER TWO: VIEWING A CATALOG
2.1 HOW TO READ A CATALOG
Start the program by typing CATALOG (Enter).
The Opening Screen Comes on. This will be one or more screens full
of company information, instructions, or other information. To go to
the next screen press any key until you get to the main menu screen.
At any menu you may use the following keys:
(Alt) (x) Exit the program
(Esc) Back out of current window
(F1) Help
(Alt) (i) Program Information
(Alt) (c) Change Colors
2.2 VIEWING CATALOG INFORMATION AND ORDERING
The Main Menu Screen may have information on the left or the
screen and a menu at the right. The menu shows up to twenty
categories of items you may look up and order.
To choose a category place the menu bar over it, using the arrow
keys to move the bar and press (Enter).
Now you will see a screen full of catalog items. If there are more
items than you can see on one screen use the (PgUp) (PgDn) (Home) (End)
keys to see more items. When you see an item of interest place the
menu bar over it and press enter. (To return to the main menu press
(Esc) .)
You may search for an item by pressing (alt) (s) . This is a case sensative search. If you are looking
for an item called "widget" type "widget" when prompted to. Type (Enter) to search forward from the
current item, or (b) to search forward from the beginning of the file. Keep in mind that you may
have to search for "WIDGET" or "Widget".
==========================================================================
Page 9
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
Now you will see a four line product description (if it is present in the
file). To order this product press (Enter) , or press (Esc) to back out.
Type the number of this product you want to order. CATALOG-ON-
A-DISK confirms your order and gives you the total for that number
of items. To accept this order press (Enter) . To change the quantity
press (r) and re-enter the quantity you want. To exit without ordering
this item press (Esc) .
You may back into the main menu screen to choose other categories
to order from. When you are done ordering go to the main menu
screen and press (Enter) . You may order up to 200 different items in
one session.
2.3 THE EXIT MENU
Now you see the Exit Menu. From Here you may print an order
form, view your order, go back to the main menu screen to order
more items, enter your name and address, or leave the program.
Printing an Order Form:
You can print the order form to your printer (to mail or fax) or to a
file on your disk (to send by modem if the company accepts orders
this way). If printing on your printer MAKE SURE YOUR
PRINTER IS ON LINE AND READY.
When printing to a file you will be prompted for a file name.
Reviewing Your Order:
Here you can see what you have ordered with the subtotal for the
whole order (tax, shipping, etc. is not included here). If there are
more items than can be seen on one screen you may view the rest by
using (PgUp) (PgDn) (Home) (End) .
To delete an item press (Del) and type the number of the item you
want to delete. The subtotal will be adjusted.
==========================================================================
Page 10
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
Go Back To Catalog:
If you want to add items to your order you can go back to the main
menu screen and order more products.
Name and Address:
CATALOG ON A DISK will remember your name and shipping
address, and print it on your order form whenever you order if you
enter it here. This is great if you order from the catalog a lot, or
even if you only order a few times.
Exit:
You may exit the program by choosing this option. You may exit to
DOS at any menu by pressing (Alt) (x) .
==========================================================================
Page 11
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER THREE: MAKING A CATALOG
For each category of items you want in your catalog you need to
create a Catalog file. You also need to create an Opening Screen file
and a Header file, and an Order Information File.
3.1 HOW TO MAKE AN OPENING SCREEN FILE
The Opening Screen file is the first information your customer sees
when he or she starts the catalog program. This can be your
company name, a brief general description of how to order,
something about your products or whatever. You will want to keep
this fairly short.
Using an ASCII text editor you can create the opening screen(s) that
your customers will see. This information will be shown, a screen at
a time, to your customers when they first start t=e program.
Make sure that no line is wider than 78 characters, and that you press
Enter at the end of the last line to put a newline character there
(otherwise the last line won't show up on the screen). When the file
is finished you must compress it (see section 4.3, "COMPRESSING
CATALOG FILES" below). The name of this file MUST be
FIRST.TXT.
3.2 HOW TO MAKE A HEADER FILE
The HEADER is the information that appears on the menu screen,
just above the menu choices.
Use an ASCII text editor to create a file that is no longer than 9 lines
long. This can have your company name, a slogan, or whatever you
want.
Make sure that no line is wider than 40 characters, and that you press
(Enter) at the end of the last line to put a newline character there
(otherwise the last line won't show up on the screen). When the file
is finished you must compress it (see section 4.3, "COMPRESSING
CATALOG FILES" below). The name of this file MUST be
HEADER.TXT.
==========================================================================
Page 12
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
3.3 HOW TO MAKE A CATALOG FILE
Using an ASCII text editor it is easy to make a catalog file. Just
follow this format: line one of the file is the category title, followed
by one description block per item in your catalog. A description
block consists of 5 lines. On the top line is the item number, a short
product description, and the price. These items must be in this order.
This is followed by a four line product write-up.
Order Number: Can be any combination of numbers, letters and
punctuation. Must have NO blank spaces. If you
do not use order numbers you must leave one
blank space at the beginning of the line.
Short Desc: Can be any number of letters, numbers and words
as long as it fits with the Order Number and
Price on 1 line (75 characters maximum).
Price: Must be numbers only. The best format to use is
XXX.XX where you show two numbers after the
decimal point, even if it is an even dollar figure.
Some good examples: .55 132.12
Write-Up: This can be any text, but it must be four lines
long. If your description is less than four lines
you must leave blank lines so the whole write-up
equals four lines (even for the last entry). If
you don't want to use write-ups, just leave four
blank lines.
It is very important that each catalog file starts with the menu title for that
file on the top line, followed by five line description blocks, because
CATALOG ON A DISK figures out what's what by counting lines in blocks
of five. If your catalog is displaying erratically it is probably because
you lost count somewhere in your file.
Line: What to type: Number of Descrptn Blks
characters
wide:
1 Menu Title 28 Title
2 Order_# Short Desc. Price 75┐ First Description
3 Product description 75│ Block
4 Product description 75│
5 Product description 75│
6 Product description 75┘
7 Order_# Short Desc. Price 75┐ Second Description
8 Product description 75│ Block
9 Product description 75│
10 Product description 75│
11 Product description 75┘
Etc.
==========================================================================
Page 13
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
Make sure that you press Enter at the end of the last line to put a
newline character there. When the file is finished you must compress
it (see section 4.3, "COMPRESSING CATALOG FILES" below).
Catalog files may have any name except the following:
first header headere firste manual cmhelp cmoshelp orderinf temp
3.3a SAMPLE CATALOG FILE
Shareware
SR1001 DARN! Don't Forget! ASP Shareware. 10.00
DARN! is a simple program. Birthday and anniversary cards, car inspections,
tax and mortgage payments will never be late again if you have this simple to
use program. Up to 300 events, sorts by date, easy searching, user sets how
many days ahead to warn, view any day.
SR2002 Programmer's SUPER-MAINT ASP Shareware. 55.00
This is the make utility you've vowed you'd write each time your current
maker annoyed you. SUPER-MAINT remembers what you are working on. In fact,
SUPER-MAINT even remembers the name of the make file! The SUPER-MAINT
editor automatically makes make files, response files and more!
SR3001 Catalog On Disk ASP Shareware. 55.00
Make a custom catalog on a floppy disk to send to your customers. Catalog
entries are easy to make in your word processor. Then Catalog On A Disk
compresses the entries so large catalogs will fit. The catalog is easy to
navigate, generates order forms that can be mailed, faxed, or sent by modem.
[End Of File]
3.4 HOW TO MAKE AN ORDER INFORMATION FILE
When CATALOG ON A DISK prints an order form it looks for a file
called ORDERINF.TXT. If it finds this file it includes the
information in it on your order form. This is where you put shipping
information, tax information, and any special ordering information,
such as information for charge card orders. Because there are so
many ways to do this, CATALOG ON A DISK lets the customer fill
in shipping, discount and tax information.
Using an ASCII text editor you can create the Order Form
Information file. You should keep this file short, to keep the order
form to one page. It will be printed at the bottom of the order form.
==========================================================================
Page 14
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
Make sure that no line is wider than 78 characters, and that you press
Enter at the end of the last line to put a newline character there
(otherwise the last line won't show up on the screen). Do NOT
compress this file.
The name of this file MUST be ORDERINF.TXT.
==========================================================================
Page 15
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER FOUR: OPTIONS
4.1 COLORS
You may change the display colors by pressing alt-c at the main
menu. There are three types of screen colors:
Main screen: Most of the displays from CATALOG
Help screen: Help screens displayed when F1 is pressed
Message screen: Special messages generated by the program.
Use the right and left arrow keys to toggle the color choices. press
enter when a choice is set. If you don't like the colors you have set,
press alt-c to set them again. NOTE: The color change doesn't take
full effect until you exit and re-enter the program.
4.2 COMMAND LINE FUNCTIONS:
CATALOG ON A DISK's catalog making functions are called from
the command line. This makes it less tempting for your customers to
change your catalog files. It is still very easy to use these functions.
Normally you call the program with a flag and a file name.
NOTES: The flags can be upper or lower case (ex. -E or -e).
You may use \ instead of - in the flag (ex: -e or \e).
The filename may come before or after the flag.
==========================================================================
Page 16
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
4.3 COMPRESSING CATALOG FILES
CATALOG ON A DISK gets all its information from compressed
files. Since compressed files are smaller than regular ASCII files you
can fit more of them on a floppy disk. It is easy to compress a file.
Let's say you want to compress HEADER.TXT. At the DOS
command line just type:
CATALOG -C HEADER.TXT
Similarly if you are compressing a file called WIDGETS, type
CATALOG -C WIDGETS
When CATALOG ON A DISK makes a catalog file it converts the
tab character to spaces. The default is eight spaces per tab. If your
word processor uses a different setting you may force CATALOG ON
A DISK to use it by using the -T flag. Call the program as above, but
adding the -T flag followed by a number. For example, to set the
tabs in your widgets file to 6 spaces, type
CATALOG -C -T6 WIDGETS
4.4 EXPORTING CATALOG FILES:
To export a compressed catalog file to ascii delimited format ("field1",
"field2", "field3", field4") you call CATALOG ON A DISK from the
command line, using the -e flag. The resulting file can then be
imported into a Database, Word Processor, etc.
Use the following syntax:
CATALOG -E FILENAME.CM
NOTES: You do not have to use the file extension.
==========================================================================
Page 17
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
4.5 IMPORTING CATALOG FILES:
CATALOG ON A DISK can import catalog files from a database or
other program that can produce an ascii delimited file in the following
format:
"Item_Number", "Short_Description", "Price", "Long_Description"
Item_Number, Short_Description, and Price should have a total
length of 70 characters or less. Long_Description can be up to 296
characters long, but should NOT have any line feed characters in it.
There should be a line feed after the last entry, or the last item on
the list won't be read in.
Use the following syntax:
CATALOG -I FILENAME.ASC
==========================================================================
Page 18
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER FIVE: COMMANDS
5.1 COMMAND SUMMARY:
(Esc) Exit
(alt) (c) Change Colors
(alt) (i) Program Information
(alt) (x) Exit
(F1) Help
5.2 COMMAND LINE FLAG SUMMARY:
-c Compress a text file to make a catalog file
-e Export a compressed catalog file to ascii delimited format
-i Import an ascii delimited file to a text file
-t# Expand tabs to # spaces
-o Import/Export No quotes on Order Number Field in ascii delimited file
-p Import/Export No quotes on Price Field in ascii delimited file
-n Nationality
==========================================================================
Page 19
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER SIX: FILES
6.1 EXPLANATION
When you want to look at a catalog, CATALOG looks for two types
of files: Default Files and Catalog Files. Both types of file have the
.CM extension.
Default files hold information for the opening screen, the catalog
header, on screen help, this manual, and so on. Some of these files
have the .CM extension (CATALOG ON A DISK's extension that
identifies compressed files).
Catalog Files are pairs of files with the catalog information in them.
CATALOG-ON-A-DISK automatically reads whichever Catalog Files
are on your disk to create the menu of categories. Catalog files
consist of a pair of files with the same name and the extensions .CM
(the compressed product information) and .TL(a short ascii file with
the category title for the main menu). For example: WIDGETS.CM
and WIDGETS.TL. There must be no more than ninety-nine of these
pairs on the disk at any one time.
6.2 LIST OF FILES
CATALOG.EXE The main program
CATALOG.INI Contains initialization information such as
color choices, buyer's name and address, etc.
FIRSTE.CM Default File. Contains the Opening Screen
information.
FIRST.CM Default File. Contains opening screen
information. If present it will be used instead
of FIRST.CM.
HEADERE.CM Default file. Contains the text that will appear
on the main menu screen.
HEADER.CM Default file. Contains opening screen text. If
present will be used instead of
HEADERE.CM.
==========================================================================
Page 20
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
ORDERINF.TXT Default file. If present this will be added to
the end of the order form. Contains charge
card, shipping and handling information,
company name and address, and so on.
XXXXXXXX.CM Catalog file. Compressed file containing
information on products
XXXXXXXX.TL Catalog File. A short ascii file containing the
category title for the main menu.
README The most up to date information about
CATALOG-ON-A-DISK
CATALOG.MAN This manual.
REG.FRM Registration form.
VENDOR.DOC Document for Shareware vendors.
CATALG.INF Description of CATALOG-ON-A-DISK
TEMP A file created and deleted by CATALOG-ON-
A-DISK for certain operations. You won't see
this in your directory, but you shouldn't keep
a file of this name in your directory, since
CATALOG-ON-A-DISK will delete it.
==========================================================================
Page 21
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER SEVEN: SHAREWARE
6.1 WHAT IS SHAREWARE?
Shareware distribution gives users a chance to try software before
buying it. If you try a Shareware program and continue using it, you
are expected to register. This allows you to try the program before
you buy it. When you register your copy of CATALOG ON A DISK
you will receive the latest version on a disk and a printed version of
this manual. You will also be assigned a serial number which entitles
you to technical support.
Copyright laws apply to both Shareware and commercial software,
and the copyright holder retains all rights, with a few specific
exceptions as stated below. Shareware authors are accomplished
programmers, just like commercial authors, and the programs are of
comparable quality. (In both cases, there are good programs and bad
ones!) The main difference is in the method of distribution. The
author specifically grants the right to copy and distribute the software,
either to all and sundry or to a specific group. For example,
EmmaSoft requires written permission before a commercial disk
vendor may copy their Shareware. (See vendor.doc for more
information.)
Shareware is a distribution method, not a type of software. You
should find software that suits your needs and pocketbook, whether
it's conventional commercial software or Shareware (Many shareware
programs ARE commercial in that a registration fee is required after
a trial period. For CATALOG ON A DISK this period is 30 days).
The Shareware system makes fitting your needs easier, because you
can try before you buy. And because the overhead is low, prices are
low also. Shareware has the ultimate money-back guarantee -- if you
don't use the product, you don't pay for it.
6.2 ASP:
The Association of Shareware Professionals (ASP) was formed to
educate shareware authors, distributors and the public about
==========================================================================
Page 22
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
shareware, to set standards for shareware, and to allow its members
to share resources and information. Programs written by ASP
members are as diverse as conventional commercial programs, but
share certain standards. Some of the ASP requirements include that
the programs are copyrighted (not public domain), that they be fully
functional (not partially functional "come ons"), and that it may be
copied (subject to copying restrictions) so that users may try the
software for a trial period before a registration fee is required.
The ASP generally congregates on the shareware forum on
CompuServe. For more information "go shareware".
6.3 ASP OMBUDSMAN ASSISTANCE
This program is produced by a member of the Association of
Shareware Professionals (ASP). ASP wants to make sure that the
shareware principle works for you. If you are unable to resolve a
shareware-related problem with an ASP member by contacting the
member directly, ASP may be able to help. The ASP Ombudsman
can help you resolve a dispute or problem with an ASP member, but
does not provide technical support for members' products. Please
write to the ASP Ombudsman at: Association of Shareware
Professionals; 545 Grover Road; Muskegon, MI 49442 or send a
Compuserve message via easyplex to ASP Ombudsman 70007,3536
==========================================================================
Page 23
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
CHAPTER EIGHT: ORDERING CATALOG ON A DISK
The registration fee for CATALOG ON A DISK is $55. (NY
residents please add sales tax.). When you register you get the
following:
1. Permission to make and distribute catalogs (you MUST
include all the original files in "file list 1" on page 4 of this
manual when you do this).
2. The registration reminder at the top of the screen is replaced
by your company's name, your name, or any message you
request (60 character maximum. If you prefer no message
here please indicate on the order form).
3. A printed manual.
4. The latest version of CATALOG ON A DISK on a disk.
5. A special offer from CompuServe to subscribe with $15 free
connect time (Subject to CompuServe still offering this).
6. Technical support.
==========================================================================
Page 24
==========================================================================
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
Registration Form
---CATALOG ON A DISK---
If you use CATALOG ON A DISK for 30 days or more,or if you
want to send out catalogs you must register your copy.
Distribution disks (registration NOT included) are $6 (plus S&L: $2
for the first disk, .50 for each additional disk*).
Registration costs $55 plus $2.50 shipping & handling.
New York residents MUST include sales tax (Mario insists!).
Help make the shareware concept work by registering.
Or register with MC or VISA by phone: (607)533-4685
All funds must be in U.S. funds and drawn on a U.S. Bank.
*U.S. only. If registering from outside the US please write about
Shipping charge before paying. (Or call, or send a message to my
Compuserve address 71460,2644). Thank you.
==========================================================================
Page 25
==========================================================================
CATALOG ON A DISK
ORDER FORM
Name:__________________________
Street Address:__________________________
__________________________
City/ST/Zip:__________________________
Disk Size:________
Custom Message:__________________________
NOTE: The Custom Message is your Company Name or a message
you want to be printed at the top of the screen and the
top of your order form. Please print legibly.
Payment: check___ MC___ VISA___
MC/VISA #:__________________________
Expires:__________________________
Signature:__________________________
No. of Copies:______ Cost:_____________
Subtotal:_____________
Shipping & Handling:_____________
NY Tax (if applicable):_____________
Total Enclosed:_____________
Send this to:
EmmaSoft
PO Box 238
Lansing, NY 14882-0238
(607)533-4685
CIS 71460,2644
==========================================================================
CATALOG-ON-A-DISK MANUAL
==========================================================================
APENDIX A: Import/Export Features
Some databases import and export numbers with no quotation marks around them
in the ascii delimited field. For this reason two command line flags have
been added to CATALOG-ON-A-DISK to allow you some flexibility in dealing with
such a situation.
Use -o when you do not want quotation marks around the Order Number field.
Use -p when you do not want quotation marks around the Price field.
Examples:
You are using a number field for price, but not order number, and you do not
want quotations around the price. To export in this format for a catalog
file called MYSTUFF.CM type the following at the command line:
catalog -e -p mystuff
The file will look something like this:
"MS402", "Sixteen Ton Widget", 64.59, "The long description goes here....."
"MS403", "Twenty Ton Widget", 89.59, "The long description goes here....."
"MS404", "Widget Extractor", 115.59, "The long description goes here....."
You may use either the -o or -p flags, both or none. The default is to put
quotation marks around every field.
APENDIX B: Nationality Setting
CATALOG-ON-A-DISK now supports two customer address formats: United States
and European styles. You use the -n (Nationality) flag to set the program
to one or the other. To do this type:
catalog -n
The program will respond, "CATALOG-ON-A-DISK set for US Style Address",
or "CATALOG-ON-A-DISK set for European Style Address."
Examples:
US Style: Name
Address
Address
City, State Zip Code
European Style: Name
Address
Address
City, Province or County, Postal Code
Country
==========================================================================
Page 27
==========================================================================